XMPlay PLX plugin (rev.1)
Copyright (c) 2018 Sebastian Sprenger. All rights reserved.

What's the point?
=================
This plugin allows XMPlay to play PMA, PMB, PNA, PNB, SMP, PMM and P2L
files. To install the plugin, put the XMP-PLX.DLL file in the same directory
as (or a sub-directory of) XMPLAY.EXE.

NOTE: You must have XMPlay 3.5 or above to use this plugin.


The "Config" window
===================

If not auto-detected:
    Makes no difference on any file I know -- and I checked all of them! :P
    But for those who do or care: In PMA files, a track can change its
    volume, and each track consists of two tones: A carrier (which you hear)
    and a modulator (which you either hear directly, too ("additive"), or
    which 'only' modifies the carrier's timbre over time). The volume change
    always affects the carrier, and the modulator only if it's additive AND
    on games until 1991 ("PSM"), but not on games since 1992 ("PSM 2.00")!
    So how would XMPlay know whether to change the modulator volume or not?

    1. In PMM files, the modulator volume is not changed (the format was
       created in 1993).

    2. In PMA files with absolute durations and rhythm mode (features that
       were already avoided by 1991), the modulator volume is changed.

    3. For any other PMA file, you may set the correct version yourself.

Voice:
    Changes the volume of the drums in PMM files. The sound system's SB16
    drivers temporarily change this.

    This is the same as "Voice" on Creative's SB16MIX.EXE 1.01 and, for
    programmers, mixer registers 0x32 and 0x33 as accessed over I/O ports
    0x224 and 0x225.

MIDI:
    Changes the volume of melodies in PMM files (but not in PMA files).

    Same as "MIDI" on SB16MIX.EXE and registers 0x34 and 0x35. The original
    sound system and this plugin have nothing to do with actual MIDI.

Mono/Stereo/Stereo reversed:
    Self-explanatory, except for what the games choose:
    The first games that used PMM files did not actually support stereo,
    even though the setup (PSMCFG3.EXE) offered it (in fact, the help pages
    admitted that stereo produced an annoying noise over time).
    Later, odd-numbered drum tracks were routed to one channel and even ones
    to another channel. Which channel was left and which was right depended
    on the game.
    There is no way to automatically detect this, so you may set it here.


PLX Display
===========
The "PLX Display" is to PMA, PNA and PMM files what the "MOD Pattern
Display" is to MOD formats and even uses the same colors and shortcuts,
except that the volumes are shown as "output levels", the width of the
columns cannot be changed, and the characters ~/+/- are not used; instead,
^/v are shown next to detuned notes.


Licence
=======
This plugin is free for use with XMPlay.

This software is provided as-is. The author makes absolutely no
warranties on it. You use it at your own risk. The author shall not
be held responsible for any damage that may result from its use.

All trademarks and other registered names contained in the XMP-PLX
"package" are the property of their respective owners.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.


Credits
=======
Based on Palladix Sound System and PSM 2.00 (c) 1988-1994 Norbert Schmidt &
Jochen He.
Contains code from DOSBox (http://dosbox.sourceforge.net), Copyright (c)
2002-2015 The DOSBox Team.


Bug reports, Suggestions, Comments, etc...
==========================================
If you have any of the aforementioned you can email:

     70 72 6F 66 2E 63 68 61 6F 73 40 6E 65 74 63 6F 6C 6F 67 6E 65 2E 64 65

Please don't expose the hex-decoded address to spam bots.

